This library allows you to launch TattleTech directly from your program as a separate process. This creates a more seamless interface for the user but requires modification of your program to accomodate the library.
As the result of various combinations of parameters to the library's single function call and the manner in which you configure TT, you would most likely use the library in one of two ways:
1) Configure TT to have its normal window interface, launch TT from your program, and have your program continue to run. This would allow the user to be interactive with your program while using TT to report profile data. If you were not able to solve the user's problem immediately, you could then instruct them to print/write the reports to file and send them to you.
-or-
2) Configure TT in a faceless mode, launch it from your program, and have it generate its reports to a file. You would have the option to either have control return to your program when TT was finished reporting or have your program terminate when TT was launched. (In faceless mode, TT itself always runs to completion and then quits.)
All of the various behaviors are available on systems 6.04 and greater. The only exception to the described functionality would be if the user were running uni-finder under System 6. This would, of course, eliminate the ability to run concurrently.
The library is in MPW.o format and is linkable to MPW and Think C or Pascal. It should also be linkable to any other environment that can accept an MPW.o format library and make toolbox style calls.
The INTERFACE to the call is:
-PASCAL-
Uses
TTLaunchUnit;
FUNCTION LaunchTT (s7SubLaunch, s7Complete, s6MSubLaunch, s6MComplete, s6SSubLaunch: boolean): OSERR;external;
-C-
extern pascal short LaunchTT( Boolean s7SubLaunch,
Boolean s7Complete,
Boolean s6MSubLaunch,
Boolean s6MComplete,
Boolean s6SSubLaunch);
PARAMETERS
The following parameters are provided to allow for different behavior under the various possible operating environments.
s7SubLaunch: If System 7, sublaunch TT and return control to launcher
s7Complete: If s7SubLaunch, return control after completion
s6MSubLaunch: If System 6/MultiFinder, sublaunch TT and return control to launcher
s7Complete: If s6MSubLaunch, return control after completion
s6SSubLaunch: If System 6/Unifinder, launch TT and re-launch caller after TT completes
NOTE: If TT is configured in Faceless mode, the "completion" parameters do not really have an effect as TT does not give up control until it has run to completion. This may change with a future version of TT which allows background processing.
ERROR CODES
0 No Error
- 7800 System 7 but Launch Control capability is missing. Cannot run TT. Very unlikely.
- 7801 64K Roms. Cannot run TT.
- 7802 Environment is not System 6.04 or greater. Cannot run TT.
- 7803 Cannot find a copy of TT in the same folder as launcher. Cannot run TT.
Other Various other standard system and toolbox errors
USE
Declare the TTLaunch function in a style appropriate to your development system. Then call TTLaunch wherever you like in your code. If you make the call from a modeless dialog, launch of TT will not occur until the dialog is dismissed. TT itself must be loacted in the same folder as your application, but may be given any name you wish.
Note: It is recommended that this library only be called from an application although there are probably certain circumstances where it might work from a DA.
NOTICE
TechTools Corp and Decision Maker's Software, Inc. (Licensor) grant no warranties, either express or implied, with regard to this software, including all implied warranties or merchantability and fitness for a particular purpose. The user indemnifies Licensor and holds Licensor harmless from all liabilities or obligations for damages arising out of or in connection with the delivery, use, or performance of this software. In no event shall Licensor be liable for incidental or consequential damages.
